home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mailbx12.zip / MAILBOX.DOC < prev    next >
Text File  |  1992-06-18  |  10KB  |  262 lines
  1.  
  2.                                 MAIL BOX    
  3.  
  4.                                   v1.2
  5.  
  6.                                    by
  7.  
  8.                               Al Lawrence
  9.  
  10.                             Sunrise-80  BBS
  11.                             (404) 256-9525
  12.  
  13.  
  14.  
  15.  
  16.                                 OVERVIEW
  17.                                 ________
  18.  
  19.  
  20.    Mail Box is a door used to allow the caller to create a Private Mail Box,
  21.    on any PCRELAY-based BBS system, running under ANY Door-Capable BBS 
  22.    software on the market today.
  23.   
  24.    All the caller does is open the door, reply to 2 options (if the Sysop 
  25.    desires), and the mail box is created. Deletion of a mail box is even 
  26.    easier, just chose the delete option and it is done.
  27.  
  28.  
  29.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  30.          created in the directory you run the door from.
  31.  
  32.  
  33.  
  34.                               INSTALLATION
  35.                               ____________
  36.  
  37.  
  38.    Installation is fairly easy and straight-forward. The following steps and
  39.    examples should have you up and running in a very short period of time.
  40.    It is assumed that you are familiar with setting up DOORS on your system.
  41.    To this end, only examples of the configuration file and Door batch file
  42.    are described.
  43.  
  44.       1) Create a directory to hold all MAILBOX files
  45.  
  46.       2) Unzip MAILBXxx.ZIP into the the above directory
  47.  
  48.          NOTE: BRUN45.EXE is not included but is required !!!
  49.  
  50.       3) Create a configuration file, with a name of your choice, or
  51.          modify the supplied MAILBOX.CFG file. A description follows:
  52.  
  53.             **                       Location of system file (See Below)
  54.             SUNRISE-80 BBS           Your BBS Name
  55.             Al                       Sysop's First nameAP
  56.  
  57.             Lawrence                 Sysop's Last Name
  58.  
  59. |-----------------------------------------------------------------------------|
  60. | READ!     1                        CommPort  \ These 2 lines are required   |
  61. | READ!     1                        Node #    / ONLY for GTUSER.BBS          |
  62. |-----------------------------------------------------------------------------|
  63.  
  64.             00000000                 Registration Number
  65.  
  66.         #   C:\PCRELAY\PRIVATE.NET   Full Drive\Path\Name of PRIVATE.NET
  67.  
  68.         #   N                        Allow caller to supply a Private Key
  69.                                      (See PCRelay Docs for explanation)
  70.  
  71.         #   N                        Allow caller to list entry in PhoneBook
  72.                                      (See PCRelay Docs for explanation)
  73.  
  74.  
  75.      
  76.               ** = Replace with ONE of the following:
  77.  
  78. C:\PCB\PCBOARD.SYS              <- For PCBoard systems using PCBOARD.SYS only
  79. C:\BBS\CALLINFO.BBS             <- For Wildcat! systems (prior to v3.0)
  80. C:\BBS\USERINFO.DAT             <- For Wildcat! systems using v3.x
  81.                                    (Note:DOOR.SYS must be in SAME directory)
  82. C:\BBS\DOOR.SYS                 <- For ANY systems that support DOOR.SYS
  83. C:\BBS\DORINFOx.DEF             <- For ANY systems that support DORINFOx.DEF
  84. C:\BBS\SFDOORS.DAT              <- For Spitfire systems.
  85. C:\BBS\CHAIN.TXT                <- For WWIV systems 
  86. C:\BBS\GTUSER.BBS               <- For GT Power 
  87.                                    * if using this option you must put the
  88.                                      ComPort # on line 5 and the Node # on
  89.                                      line 6 of the configuration file
  90.  
  91.  
  92.  
  93.            # = Requires registration to change to a different value.
  94.  
  95.                NOTE: There are NO Blank Lines in the Config File!!
  96.  
  97.  
  98.  
  99.  
  100.       4) Create a batch file or modify the MAILBOX file supplied. A
  101.          description of this file follows:
  102.  
  103.             ECHO off
  104.             cd\PCB\DOORS\MAILBOX      Location of MAILBOX files
  105.             MAILBOX MAILBOX.CFG       EXE filename and CFG filename (Name
  106.                                       used in creating file in #3 above)
  107.             CD\PCB
  108.             BOARD
  109.  
  110.  
  111.        5) When running in more than one node, see multi-node section below.
  112.  
  113.  
  114.                         NON-STANDARD COM SUPPORT
  115.                         ________________________
  116.  
  117.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  118.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  119.       number after the configuration filename. Let's assume your Door is
  120.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  121.       passed to your Door would be:
  122.  
  123.                             FOOBAR FOOBAR.CFG /5
  124.  
  125.       The /5 tells FOOBAR to use IRQ5 rather than the standard IRQ4 that is
  126.       normally used with COM1. No /x parameter is needed for the standard
  127.       IRQ's.
  128.  
  129.       As an alternative, you may use an environmental variable on the command
  130.       line. To use the variable (following the example above), place a 
  131.       SET IRQ=5 in the batch file used to bring up your BBS (you would need a 
  132.       different IRQ number for each node). The command line would now look 
  133.       like this: 
  134.  
  135.                           FOOBAR FOOBAR.CFG /%IRQ%
  136.       
  137.       This, in combination with the use of the environmental variables 
  138.       described in the MULTI-NODE SETUP section will allow you to use one 
  139.       batch file and one config file to run this door on all nodes.
  140.  
  141.  
  142.  
  143.  
  144.                            MULTI-NODE SETUP
  145.                            ________________
  146.  
  147.       All Sunrise Doors are Multi-Node capable. Each node must have the 
  148.       ability to access a configuration file which will have its own system 
  149.       file (DORINFOx.DEF, PCBOARD.SYS, DOOR.SYS, etc) defined on the first 
  150.       line. There are 2 ways to accomplish this:
  151.  
  152.       (1) Create a separate configuration file for each node. The only 
  153.           difference between each file would be the location of the system 
  154.           file for that particular node. For example, on my system there are 2
  155.           nodes and the first line of the config files would look like this:
  156.  
  157.                         NODE1:  H:\PCB1\DOOR.SYS
  158.                         NODE2:  H:\PCB2\DOOR.SYS
  159.  
  160.           Thus, if you have a 4 node BBS, you will need 4 configuration files.
  161.  
  162.       (2) Use ONE configuration file for ALL nodes. This Door will recognize 
  163.           the following PCBoard environmental variables:
  164.  
  165.                  PCBDIR    (Directory containing the System file)
  166.                  PCBDRIVE  (Drive containing the System file)
  167.  
  168.           Thus, the first line of the SINGLE configuration file, for this Door
  169.           would look like this:
  170.  
  171.                         %PCBDRIVE%%PCBDIR%\DOOR.SYS
  172.  
  173.       NOTE: This option, as described, assumes that you are running PCBoard 
  174.             14.5a software. The environmental variables are automatically 
  175.             created by the software for each node.
  176.  
  177.             HOWEVER, if you are running other BBS software you should be able
  178.             to set the variables EXACTLY as described below, for EACH node 
  179.             (more than likely in each batch file you use to bring up EACH node):
  180.  
  181.                             PCBDRIVE=C:
  182.                             ^^^^^^^^^
  183.                             PCBDIR=\NODE2
  184.                             ^^^^^^^^
  185.             
  186.             Info with a carat (^) under it, MUST be typed as is. The rest 
  187.             depends on your naming conventions. 
  188.  
  189.             This, in combination with the use of the optional environmental
  190.             variable described in the NON-STANDARD COM SUPPORT section, will
  191.             allow you to use one batch file and one config file to run this 
  192.             door on all nodes.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                               LEGALITIES
  199.                               __________
  200.  
  201.  
  202.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  203.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  204.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  205.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  206.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  207.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  208.       OR BREACH OF ANY WARRANTY.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.                              DISTRIBUTION
  215.                              ____________
  216.  
  217.    You may make this file available for downloading from your BBS or you may
  218.    upload it to any BBS of your choice, provided that you do not make any
  219.    changes to the contents of the archive (ZIP file). The archive and its
  220.    individual contents may not be used by any service that charges any money
  221.    whatsoever, without the written permission of the author.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.                              REGISTRATION
  228.                              ____________
  229.  
  230.   YOU ARE GRANTED A 10 DAY EVALUATION PERIOD. YOU MUST REGISTER AFTER THAT
  231.   PERIOD OF TIME OR REMOVE THIS PROGRAM FROM YOUR SYSTEM!!!!!!
  232.  
  233.    Registration and the subsequent insertion of the registration number into
  234.    your configuation file, allows for the display of your BBS name on the
  235.    opening and closing screen as well as the reduction of a delay built into
  236.    the opening screen display along with the ability to change certain
  237.    values in the configuration file.
  238.  
  239.    To register your copy of MAILBOX, please fill out the registration form
  240.    (REGISTER.FRM) and mail it along with a registration fee of $20 to
  241.    the name and address on the form.
  242.  
  243.    Be sure to use the proper upper/lower case when filling in your name and
  244.    BBS name, as they MUST match the way you entered them in the configuration
  245.    file.             ^^^^
  246.  
  247.    Based upon information supplied on the registration form, I will pre-
  248.    register you on my BBS. You will then be able to call SUNRISE-80 and pick
  249.    up your registration number.
  250.  
  251.  
  252.  
  253.                                  MISC
  254.                                  ____
  255.  
  256.    The latest version of MAIL BOX and other fine SUNRISE DOOR programs
  257.    are always available for download from SUNRISE-80 BBS.
  258.  
  259.    Remember, should you have any problems, questions or suggestions, be sure
  260.    to drop me a message on Sunrise-80 or in the RIME network (BBS_Doors, 
  261.    PCBHints, SYSops) or on SMARTNET (SN_Sysops) OR Fido 1:133/410
  262.